home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 42 / Amiga Format AFCD42 (Issue 126, Aug 1999).iso / -serious- / comms / other / ambos-update / ambos / toolbox / vera / vera.readme < prev    next >
Text File  |  1999-05-17  |  11KB  |  233 lines
  1. Short:  VerA 2.05 - Version Information für AmBoS (ab Kickstart 3.0)
  2. Author: spock@ebase.capella.de (Lars Maschmann)
  3.  
  4.  Einleitung
  5.  ----------
  6.  
  7.  Wie oft stellt sich die Frage: Habe ich bei allen Programmteilen die
  8.  aktuelle Version installiert? Fehlt mir eine Datei?
  9.  
  10.  Mit diesem Script kann schnell der aktuelle Versionsstand der AmBoS-
  11.  Installation ermittelt werden. 
  12.  Es kann entweder eine Bildschirmausgabe erfolgen oder eine Logdatei
  13.  mit den Ergebnissen erstellt werden. Zusätzlich kann ab Version 2.0
  14.  die Logdatei auch direkt in das AmBoS-Net gepostet werden. Hierfür
  15.  benötigt VerA folgendes:
  16.  
  17.   - in BBS:Setup werden zwei Konfigurationsdateien abgelegt:
  18.   
  19.     VerA_Username.config - enthält den Usernamen des
  20.                            Senders (z.B. Gary)
  21.     VerA_Address.config  - enthält den Boxnamen und die Domain des
  22.                            Systems (z.B. heart.capella.de)
  23.                            
  24.     Diese Dateien werden bei Erstbenutzung automatisch angelegt. Zum
  25.     dauerhaften Einstellen dieser Daten sollten diese Dateien zuerst
  26.     gelöscht und dann mit den Schaltern USERNAME und ADDRESS gesetzt
  27.     werden. VerA legt dann die Dateien mit den übergebenen Werten
  28.     an.
  29.     
  30.   - Das Tool "SortPuffer" muß sich im Verzeichnis "BBS:Netz" befinden
  31.     oder sich im aktuellen Suchpfad befinden.
  32.   
  33.     SortPuffer © Uwe Rosenkranz / AmBoS-Team
  34.  
  35.   - Das Tool "MakeZCMail" muß sich im Verzeichnis "BBS:Toolbox/MakeZCMail"
  36.     befinden oder sich im aktuellen Suchpfad befinden. Das Archiv liegt
  37.     nicht bei!
  38.     
  39.     MakeZCMail ist (C) by Mirko Thöle  (TMS@DAME.DE)
  40.  
  41.  Benutzung
  42.  ---------
  43.  
  44.  Neu:
  45.  VerA kann ab sofort auch über ein Icon gestartet werden. Es ist sogar
  46.  möglich, für einige Schalter ToolTypes zu definieren. 
  47.  
  48.  Folgende Schalter sind möglich:
  49.  
  50.  NOHEAD     : Es werden keine Überschriften in der Ergebnisliste erzeugt.
  51.               Auch als ToolType im Icon möglich.
  52.  
  53.  FULL       : Detaillierte Ergebnisliste: Vollständiger Pfadname und
  54.               erweiterte Versionsinformationen. 
  55.               Auch als ToolType im Icon möglich.
  56.  
  57.  DISPLAY    : Es erfolgt eine Ausgabe der Ergebnisliste auf dem Bild-
  58.               schirm. Wird mit TO eine Datei angegeben, so wird diese
  59.               zwar erzeugt, aber nach der Ausgabe gelöscht.
  60.               Auch als ToolType im Icon möglich.
  61.  
  62.  NOANSI     : Bei der Ausgabe mit DISPLAY werden keine ANSI-Sequenzen
  63.               benutzt.
  64.               Auch als ToolType im Icon möglich.
  65.               Ist der Schalter POST gesetzt, werden grundsätzlich
  66.               keine ANSI-Steuerzeichen benutzt.
  67.  
  68.  TO         : Angabe der Logdatei. Wird nichts angegeben, so werden die
  69.               Ergebnisse in die Datei T:VerA.log geschrieben.
  70.               Wird dieser Wert nicht angegeben, und ist QUIET nicht
  71.               gesetzt, dann erscheint ein Dateirequester, mit dem die
  72.               Logdatei angegeben werden kann.
  73.  
  74.  QUIET      : Es erscheinen keine Ausgaben bei der Erstellung der Logdatei.
  75.               Ist QUIET aktiviert, erscheinen keinerlei Bildschirm-
  76.               ausgaben (Text oder Requester). Fehler werden - falls
  77.               möglich - in die Logdatei geschrieben.
  78.               Auch als ToolType im Icon möglich.
  79.  
  80.  VIEWER     : Optional kann ein Anzeigeprogramm (z.B. MultiView) angegeben
  81.               werden. Dieses Programm zeigt dann am Ende die Logdatei an,
  82.               unabhängig davon, ob DISPLAY gesetzt ist oder nicht.
  83.               VIEWER benötigt als Schlüsselwort den Namen eines Anzeige-
  84.               programms. Wird dieses Programm nicht gefunden, so wird 
  85.               die Ausführung abgebrochen.
  86.               
  87.               Wird weder QUIET, noch VIEWER, noch DISPLAY angebenen, so
  88.               erscheint am Ende eine Abfrage, ob die Logdatei angezeigt
  89.               werden soll. Hierfür wird standardmäßig MultiView oder
  90.               Ed (falls MultiView nicht gefunden wurde) benutzt.
  91.               
  92.  IGNOREICON : Eventuell eingestellte ToolTypes im Icon werden ignoriert.
  93.  
  94.  POST       : Dieser Schalter veranlaßt VerA, die Logdatei in das AmBoS-
  95.               Net zu posten. Das klappt nur, wenn die oben genannten Be-
  96.               dingungen erfüllt sind und AmBoS sowieso das ZConnect.mod
  97.               aktiv sind.
  98.               Wird dieser Schalter benutzt, so erscheint keine Abfrage,
  99.               ob die erzeugte Logdatei angezeigt werden soll (außer,
  100.               es wurde explizit unter VIEWER ein Anzeigeprogramm de-
  101.               finiert).
  102.               Ist dieser Schalter aktiviert, so werden keine ANSI-
  103.               Zeichen in der Logdatei benutzt, es erfolgt auch keine
  104.               Abfrage des Logdateinamens.
  105.               
  106.  USERNAME   : Übergabe des Usernamens für den ABS:-Header (nur in 
  107.               Verbindung mit POST von Bedeutung). Existiert noch
  108.               keine Konfigurationsdatei BBS:Setup/VerA_username.config,
  109.               so wird dieser Parameter in die Datei geschrieben.
  110.  
  111.  ADDRESS    : Übergabe der Adresse (Systemname.Domain) für den ABS:-
  112.               Header (nur in Verbindung mit POST von Bedeutung). 
  113.               Existiert noch keine Konfigurationsdatei BBS:Setup/
  114.               VerA_address.config, so wird dieser Parameter in die 
  115.               Datei geschrieben.
  116.  
  117.  OBJECT     : Hiermit kann nur ein bestimmtes Objekt untersucht werden.
  118.               Folgende Schlüsselwörter sind möglich: AMBOS, ZCONNECT, MISC.
  119.               Es genügt auch, einfach nur das Schlüsselwort ohne "OBJECT"
  120.               anzugeben.
  121.            
  122.  Achtung: Dieser Script benutzt ausschließlich die original AmigaOS-
  123.           CLI-Befehle. Voraussetzung ist der Versions-Befehl mit der
  124.           Versionsnummer 39.4 (WB 3.0) oder 40.1 (WB 3.1).
  125.           Zum automatischen Posten sind zusätzlich die Tools "SortPuffer"
  126.           und "MakeZCMail" nötig.
  127.           
  128.  Wichtig: Um VerA bequem ohne 'execute' starten zu können, muß das S-Flag
  129.           aktiviert sein: 
  130.           
  131.           1> protect vera s add
  132.           
  133.  Beispiele
  134.  ---------
  135.  
  136.  1> VerA zconnect full viewer MultiView quiet
  137.  
  138.  Ermittelt alle Versionen vom ZConnect-Modul, Ausgabe aller Infor-
  139.  mationen (Dateipfade und erweiterte $VER-Beschreibungen), abschließende
  140.  Anzeige mit MultiView, keine Ausgaben in das Programmfenster.
  141.  
  142.  1> VerA nohead display noansi 
  143.  
  144.  Ermittelt Versionen aller Objekte, komprimierte Ausgabe ohne Über-
  145.  schriften, Anzeige der Logdatei im Programmfenster, es werden keine
  146.  ANSI-Sequenzen für Hervorhebungen benutzt.
  147.  
  148.  1> VerA to RAM:AmBoSVer.log quiet ambos
  149.  
  150.  Ermittelt  alle Versionen vom AmBoS-Hauptprogramm und schreibt diese
  151.  in die Protokolldatei 'RAM:AmboSVer.log', keine Bildschirmausgaben.
  152.  
  153.  1> VerA TO T:VerA-Logfile post all username Gary address heart.capella.de
  154.  
  155.  Erstellt von allen Objekten eine Logdatei und postet sie in das
  156.  AmBoS-Net, Absender: Gary@heart.capella.de.
  157.  
  158.  Einbindung in das "Ext. Tools"-Menü von AmBoS
  159.  ---------------------------------------------
  160.  
  161.  Zum Posten der aktuellen Software-Konfiguration in das AmBoS-Net
  162.  sollte in die Datei 'BBS:Setup/ExtTools.menu' diese Zeile eingetragen
  163.  werden:
  164.  
  165.  VerA posten, Execute BBS:Toolbox/VerA/VerA QUIET ALL POST IGNOREICON 
  166.   FULL USERNAME <username> ADDRESS <systemname.domain>
  167.   
  168.  Für <username> und <systemname.domain> sind selbstverständlich die
  169.  entsprechenden Werte einzutragen. Nach dem nächsten AmBoS-Neustart
  170.  sollte der Eintrag "VerA posten" im Menü auftauchen und auch sofort
  171.  benutzbar sein.
  172.  
  173.           
  174.  History
  175.  -------
  176.  Version 2.05: MapsBefehle/HOLDON und HOLDOFF korrigiert
  177.  Version 2.04: Existenzcheck BBS:Texte/SystemNachrichten.txt eingebaut.
  178.  Version 2.03: SortPuffer wird auch in BBS:Toolbox/Sortpuffer gesucht.
  179.  Version 2.02: Pfad für ZConnect.Guide um /deutsch/ erweitert.
  180.  Version 2.01: Bei POST keine Logdateiabfrage mehr. Schalter USERNAME
  181.                und ADDRESS eingebaut. Suchpfad für SortPuffer und Make-
  182.                ZCMail wird benutzt (kein absoluter Aufruf mehr nötig).
  183.  Version 2.00: POST-Funktion eingebaut.
  184.  Version 1.31: Die neue Guide-Struktur wurde berücksichtigt
  185.  Version 1.30: Der AmBoS-Handler hat nun endlich eine $VER-Kennung!
  186.  Version 1.29: Einige neue Guides aufgenommen, Mapstexte werden nun
  187.